<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>iTorrent FAQ</title>
<link rel="stylesheet" href="style.css" type="text/css" />
</head>

<body>
<div class="header">
<h1 style="text-align: center">iTorrent</h1>
</div>

<h4 id="faq">FAQ:</h4>
<dl>
  <dt id="podcast-url">
  How do I know what the URL of podcast is?
  </dt>
  <dd>
  On the web page for every podcast, there is a link such as
  <img src="images/xml.png" alt="XML" />, <img src="images/rss.png" alt="RSS" />,
  or maybe <img src="images/feed.png" alt="Feed" />. (Do not use iTunes links, such as
  <img src="images/itunes.png" alt="iTunes" />, since they are not standard podcast feeds.)
  Simply right-click on the link and select "Copy Shortcut" or
  "Copy Link Location". You can then paste the URL when you
  <a href="#enter-url">subscribe in iTunes</a>.<br />
  <img src="images/copy-link.png" style="border: 1px solid black" alt="Copy Link" />
  </dd>

  <dt id="enter-url">
  How do I subscribe to a podcast URL into iTunes?
  </dt>
  <dd>
  If you have never manually entered a podcast URL into iTunes before, you can
  do so by selecting "Subscribe to Podcast..." under the "Advanced" menu:<br />
  <img src="images/subscribe-menu.png" alt="Subscribe Menu" />
  </dd>

  <dt id="port-in-use">
  When iTorrent starts up, it tells me that port 80 cannot be used. What do I do?
  </dt>
  <dd>
  Either you have accidentally started up two copies of iTorrent, or there is a
	web server already running on your machine. If port 80 is already in use by
	another program such as a web server, then you will need to use a different
	port number, as described <a href="#other-port">below</a>:
  </dd>

  <dt id="other-port">
  I don't want iTorrent to use port 80, how do I use a different one?
  </dt>
  <dd>
  To use a port other than 80, you need to use the <code>--control_port</code>
  command-line option. For instructions on how to use command-line options,
  refer to the <a href="advanced.html">advanced use</a> page. For example, to
  use port 3333, you would invoke iTorrent with this command-line:
  <pre>> iTorrent --control_port 3333</pre>
  Now, you must specify port 3333 in all of your proxied URLs by prefixing them
  with "http://localhost:3333/". For example:
  "<span style="color: blue">http://localhost:3333/</span>http://podcast.org/torrents.rss".
  </dd>

	<dt id="why-password">
	Why does iTorrent ask me for my password on OS X?
	</dt>
	<dd>
	iTorrent uses port 80 as its default port, but port 80 is considered to be a
	reserved port that can only be used by superusers. iTorrent therefore asks for
	your password so that it can use port 80 as a priviledged superuser.<br />
	<br />
	Technically, iTorrent uses a small helper utility that listens to port 80 on
	its behalf. The first time you run iTorrent, it asks for your password in
	order to setup the helper utility with superuser permissions so that it can
	use port 80.
	</dd>

  <dt id="console-flash">
  When I double-click on <code>itorrent.py</code>, the console window pops up,
	flashes some text, and then quickly closes again. What's going on?
  </dt>
  <dd>
	iTorrent has encountered an error while trying to initialize. If you are using
	the alpha-1 release of iTorrent on Windows, there was an undocumented
	dependency on Win32 Extensions and ctypes. You can find and install those
	Python packages, but it is much easier to simply upgrade to alpha-2 or
	higher.<br />
	<br />
	For any other problem, there should be a <code>debug.dump</code> file either
	in the iTorrent directory or in the data directory below the iTorrent
	directory. Please submit a bug report at
	<a href="http://sourceforge.net/tracker/?func=add&amp;group_id=163841&amp;atid=829332">
	http://sourceforge.net/tracker/?func=add&amp;group_id=163841&amp;atid=829332</a>
	and attach the <code>debug.dump</code> file to the submission.
  </dd>

  <dt id="other-readers">
  Does iTorrent work with podcast readers other than iTunes?
  </dt>
  <dd>
  In theory, yes, you can enter proxied URLs into any podcast reader in order to
  make it use iTorrent. iTorrent has been specifically tuned and tested to work
  with iTunes 6, however, and your milage may vary with any other podcast reader.
  </dd>

  <dt id="future-plans">
  What are the future plans for iTorrent?
  </dt>
  <dd>
  A later release of iTorrent will feature a nifty GUI that will let you
  see the progress of each download. It may also contain any other features that
  are backed by popular demand.
  </dd>

  <dt id="how-smooth">
  Technical: How does iTorrent smooth out the downloads for non-BitTorrent podcasts?
  </dt>
  <dd>
  When iTunes updates a podcast, it has the nasty habit of spiking the CPU to
  100% while it waits for the first few kilobytes of data. When it updates more
  than one podcast at a time, each update will try to consume 100% CPU time on
  its own. The result is that some of the updates will be starved of CPU time
  and eventually timeout. iTorrent resolves this problem by prefetching the
  first 2KB of each podcast, which it then immediately feeds to iTunes whenever
  it updates. The immediate feedback prevents iTunes from spiking the CPU for
  extended periods of time and starving itself.
  </dd>
</dl>

<div class="footer">
<p style="text-align: center">
<a href="index.html">Introduction</a> |
<a href="advanced.html">Advanced Use</a> |
FAQ |
<a href="contact.html">Contact Info</a>
</p>
</div>

</body>
</html>
